Partially update a Job Family Skill Profile with feedback

curl --request PATCH \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/job_families/{job_family_external_id}/skill_profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "oracle",
  "skills": [
    {
      "skill_id": "c110316a-41d3-46ef-a35e-dbb27785b1c8",
      "has_skill": true
    },
    {
      "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
      "has_skill": true,
      "proficiency_level": 2
    },
    {
      "skill_id": "a05c0764-3cde-9200-b6a4-dds7639987ff",
      "has_skill": true,
      "proficiency_float": 0.4,
      "critical": null
    },
    {
      "skill_id": "e03c1859-3bae-4700-b2c5-ede2937038de",
      "has_skill": false
    }
  ]
}
'

[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

PATCH

job_architecture

job_families

{job_family_external_id}

skill_profile

Partially update a Job Family Skill Profile with feedback

curl --request PATCH \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/job_families/{job_family_external_id}/skill_profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "oracle",
  "skills": [
    {
      "skill_id": "c110316a-41d3-46ef-a35e-dbb27785b1c8",
      "has_skill": true
    },
    {
      "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
      "has_skill": true,
      "proficiency_level": 2
    },
    {
      "skill_id": "a05c0764-3cde-9200-b6a4-dds7639987ff",
      "has_skill": true,
      "proficiency_float": 0.4,
      "critical": null
    },
    {
      "skill_id": "e03c1859-3bae-4700-b2c5-ede2937038de",
      "has_skill": false
    }
  ]
}
'

[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

feedback_format

enum<string>

default:skills

The format in which feedback for the Skill Profile is given.

Available options:

skills,

external_vendor_skills

Example:

"skills"

Body

application/json

Skills
External Vendor Skills

source

string

The source of the Skill Profile update.

Example:

"oracle"

skills

object[]

The Skills contained in this profile. Either skill or skill_id must be provided, but not both.

Show child attributes

skills.skill_id

string<uuid>

required

The universally unique ID of the Skill, consisting of alphanumeric characters, hyphens and underscores. The Skill name connected to this id can be identified by either using the Skill Search endpoint or in any response body that contains that Skill.

Required string length: 1 - 100

Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

skills.has_skill

boolean

required

Indicates whether the Skill is present. Cannot be false if the Skill is not present in the Skill Profile of the entity.

skills.skill

string

deprecated

The name of the Skill.

Minimum string length: 1

Example:

"Machine Learning"

skills.proficiency_level

integer<int32> | null

The required proficiency level for this Skill that is associated with the entity. Setting this to null will remove any existing proficiency level from the Skill for this entity. You can only set this for a Skill that is validated (has_skill should be true). proficiency_level and proficiency_float are mutually exclusive!

Required range: x >= 1

skills.proficiency_float

number<float> | null

The required proficiency level (passed as a float) for this Skill that is associated with the entity. Setting this to null will remove any existing proficiency level from the Skill for this entity. You can only set this for a Skill that is validated (has_skill should be true). proficiency_level and proficiency_float are mutually exclusive!

Required range: 0 < x <= 1

skills.critical

boolean | null

Indicates whether the Skill is critical for the entity. Setting this to null will remove the critical flag from the Skill. You can only set this for a Skill that is validated (has_skill should be true).

Example:

[
  {
    "skill_id": "c110316a-41d3-46ef-a35e-dbb27785b1c8",
    "has_skill": true
  },
  {
    "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
    "has_skill": true,
    "proficiency_level": 2
  },
  {
    "skill_id": "a05c0764-3cde-9200-b6a4-dds7639987ff",
    "has_skill": true,
    "proficiency_float": 0.4,
    "critical": null
  },
  {
    "skill_id": "e03c1859-3bae-4700-b2c5-ede2937038de",
    "has_skill": false
  }
]

Response

No Content

Get the Skill Profile for a Job Family Get the suggested Skill Profile for a Job Family

⌘I

API Documentation

API Versioning

Taxonomy

Employees

Job Families

Jobs

Peer Groups

Vacancies

Courses

Skill Clusters

External Companies

Skills

Organisational Structure

Custom Properties

Matchmaking

Matching Configuration

Export

Reports

Version

Partially update a Job Family Skill Profile with feedback

Authorizations

Query Parameters

Body

Response